home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1538.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  4.4 KB  |  183 lines
  1. 131
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. CopyXFilesProgress 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows and Macintosh
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baCopyXFilesProgress copies multiple files, while displaying a progress dialog
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = baCopyXFilesProgress( SourceDir , DestDir , FileSpec, Overwrite, Title, 
  28. --- RECORDSEPARATOR ---
  29. ButtonText, Flags )
  30. --- RECORDSEPARATOR ---
  31.  
  32. --- RECORDSEPARATOR ---
  33. Arguments:
  34. --- RECORDSEPARATOR ---
  35.  
  36. --- RECORDSEPARATOR ---
  37. String, string, string, string, string, string, integer. 
  38. --- RECORDSEPARATOR ---
  39. SourceDir is the folder to copy from. 
  40. --- RECORDSEPARATOR ---
  41. DestDir is the folder to copy to. 
  42. --- RECORDSEPARATOR ---
  43. FileSpec determines what files are copied. 
  44. --- RECORDSEPARATOR ---
  45. Overwrite determines how the copy is done. Can be: 
  46. --- RECORDSEPARATOR ---
  47. "Always" 
  48. --- RECORDSEPARATOR ---
  49. always copies the file 
  50. --- RECORDSEPARATOR ---
  51. "IfNewer" 
  52. --- RECORDSEPARATOR ---
  53. copies the file if SourceFile is newer than DestFile 
  54. --- RECORDSEPARATOR ---
  55. "IfNotExist" 
  56. --- RECORDSEPARATOR ---
  57. copies only i
  58. --- RECORDSEPARATOR ---
  59. f DestFile does not already exist 
  60. --- RECORDSEPARATOR ---
  61. Title is the title of the dialog box. 
  62. --- RECORDSEPARATOR ---
  63. ButtonText is the text to use in the Cancel button. 
  64. --- RECORDSEPARATOR ---
  65. Flags changes the behaviour of the dialog, see notes for details.
  66. --- RECORDSEPARATOR ---
  67.  
  68. --- RECORDSEPARATOR ---
  69. Returns:
  70. --- RECORDSEPARATOR ---
  71.  
  72. --- RECORDSEPARATOR ---
  73. Integer. 
  74. --- RECORDSEPARATOR ---
  75. Returns 0 if the file was copied successfully, otherwise one of these: 
  76. --- RECORDSEPARATOR ---
  77. 1 
  78. --- RECORDSEPARATOR ---
  79. Invalid Source file name 
  80. --- RECORDSEPARATOR ---
  81. 2 
  82. --- RECORDSEPARATOR ---
  83. Invalid Dest file name 
  84. --- RECORDSEPARATOR ---
  85. 3 
  86. --- RECORDSEPARATOR ---
  87. Error reading the Source file 
  88. --- RECORDSEPARATOR ---
  89. 4 
  90. --- RECORDSEPARATOR ---
  91. Error writing the Dest file 
  92. --- RECORDSEPARATOR ---
  93. 5 
  94. --- RECORDSEPARATOR ---
  95. Couldn't create directory for Dest file 
  96. --- RECORDSEPARATOR ---
  97. 6 
  98. --- RECORDSEPARATOR ---
  99. Dest file exists 
  100. --- RECORDSEPARATOR ---
  101. 7 
  102. --- RECORDSEPARATOR ---
  103. Dest file is newer that Source file 
  104. --- RECORDSEPARATOR ---
  105. 8 
  106. --- RECORDSEPARATOR ---
  107. No files matched the specified type 
  108. --- RECORDSEPARATOR ---
  109. 9 
  110. --- RECORDSEPARATOR ---
  111. User cancelled the copy
  112. --- RECORDSEPARATOR ---
  113.  
  114. --- RECORDSEPARATOR ---
  115. Examples:
  116. --- RECORDSEPARATOR ---
  117.  
  118. --- RECORDSEPARATOR ---
  119. Director: 
  120. --- RECORDSEPARATOR ---
  121. OK = baCopyXFilesProgress( "c:\data" , "d:\backup" , "*.dat", "IfNewer", "Backing 
  122. --- RECORDSEPARATOR ---
  123. up files... ", "Cancel", 0 ) 
  124. --- RECORDSEPARATOR ---
  125. Authorware: 
  126. --- RECORDSEPARATOR ---
  127. OK := baCopyXFilesProgress( "c:\\data" , "d:\\backup" , "*.dat", "IfNewer" , "Backing 
  128. --- RECORDSEPARATOR ---
  129. up files... ", "Cancel", 0 )
  130. --- RECORDSEPARATOR ---
  131.  
  132. --- RECORDSEPARATOR ---
  133. Notes:
  134. --- RECORDSEPARATOR ---
  135.  
  136. --- RECORDSEPARATOR ---
  137. By default, this function will not overwrite an existing file if that file is marked as 
  138. --- RECORDSEPARATOR ---
  139. read-only. However, on Windows, by adding 
  140. --- RECORDSEPARATOR ---
  141. "
  142. --- RECORDSEPARATOR ---
  143. +
  144. --- RECORDSEPARATOR ---
  145. " 
  146. --- RECORDSEPARATOR ---
  147. to the 
  148. --- RECORDSEPARATOR ---
  149. "
  150. --- RECORDSEPARATOR ---
  151. Always
  152. --- RECORDSEPARATOR ---
  153. " 
  154. --- RECORDSEPARATOR ---
  155. and 
  156. --- RECORDSEPARATOR ---
  157. "
  158. --- RECORDSEPARATOR ---
  159. IfNewer
  160. --- RECORDSEPARATOR ---
  161. " 
  162. --- RECORDSEPARATOR ---
  163. options (eg "Always+" or "IfNewer+"), the destination files will be overwritten if they 
  164. --- RECORDSEPARATOR ---
  165. are read-only. 
  166. --- RECORDSEPARATOR ---
  167. The return value will not be 0 if any file is not copied. For example, if you specify 
  168. --- RECORDSEPARATOR ---
  169. baCopyXFilesProgress( "c:\data" , "d:\backup" , "*.*" , "IfNewer", ....... ) 
  170. --- RECORDSEPARATOR ---
  171. and any of the files in c:\data are newer than the ones in d:\backup, the return 
  172. --- RECORDSEPARATOR ---
  173. result will be 7 (Dest file is newer than Source). A result of 0 will be returned only if 
  174. --- RECORDSEPARATOR ---
  175. none of the files in c:\data is newer than d:\backup. 
  176. --- RECORDSEPARATOR ---
  177. A return value of 6 (Dest file exists) can only be returned when Overwrite is 
  178. --- RECORDSEPARATOR ---
  179. "IfNotExist".
  180. --- RECORDSEPARATOR ---
  181.  
  182. --- RECORDSEPARATOR ---
  183. (continued next page)